home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Scope / Scope Disk #048 (199x)(Scope PD)(US)[WB].zip / Scope Disk #048 (199x)(Scope PD)(US)[WB].adf / ShowFont32 / showfont.doc < prev    next >
Text File  |  1989-01-02  |  11KB  |  201 lines
  1.                      ShowFont 3.2 - by Arthur Johnson Jr.
  2.                      ====================================
  3.  
  4.                           Last update date - 12/20/88
  5.                           ---------------------------
  6.  
  7. ****************************************************************************
  8. * To see just the changes since revision ?.?, check out the improved       *
  9. * "Revisions n' Updates" section at the end of this documentation!         *
  10. ****************************************************************************
  11.  
  12.      This program allows you to quickly and painlessly view all 256
  13. characters in a typical font.  I wrote it because using FontEd or (choke!)
  14. NotePad to see what a font looks like can be slow, tedious, monotonous, etc.
  15.  
  16.      To use this program, simply type "ShowFont [font_name] [font_size]".
  17. Both the [font_name] (Topaz, Ruby, etc.) and [font_size] (8, 12, etc.) are
  18. purely optional.  If you do not specify a size, ShowFont will check all your
  19. available fonts and then show you what sizes/styles of the font you wanted
  20. exist.  If you also omitted the font, you can select what font/size/style to
  21. see by using the font requester.  More on this below.  Note that you
  22. currently cannot select a [font_style] to see.  You must do this through the
  23. requester.  ShowFont currently hits the fan when it encounters a size with
  24. multiple styles, i.e., italics AND underlined.  It won't bomb, but it "has
  25. trouble" finding/displaying the correct font.
  26.  
  27.      By the way, if someone makes an icon for this program, it might just
  28. run from WorkBench.  Since I never use WorkBench, I haven't bothered testing
  29. this.  (Version 3.2 note: I still haven't bothered)
  30.  
  31.      So, what's the font selector like?  Well, I've tried to make it pretty
  32. standard, including all the neat features most of the better ones have.  To
  33. select a font, size, or style, simply click on it with the left button.
  34. When you have the desired font, size, and style selected, press the OK
  35. button.  You can now (3.1) just double-click on the font, size, or style to
  36. view the font, size, and style you like.
  37.      To scroll around the font, size, and style lists, click on the arrows
  38. or slider gadgets.  Since you've probably used their like in other programs,
  39. you probably already know what they do.  Note that you can hold down the
  40. left button over these gadgets and the list will scroll rapidly (Version 3.2
  41. note: extremely rapidly) in the direction of the arrow you're over.  You can
  42. also do this with the slider gadget and move up and down to scroll over the
  43. whole list.  To stop the scrolling, release the button.
  44.      If you decide you really don't want to look at a different font than
  45. what you had been checking out, press the CANCEL button.
  46.  
  47. /**************************************************************************/
  48. /*      Because most everyone changes their Preferences colors, the       */
  49. /* colors I mention below might not be correct for your system.  Just     */
  50. /* translate what the colors should be on your system (if you've changed  */
  51. /* them).  The original colors were blue, white, black, and orange (in    */
  52. /* order of how you can change them in Preferences).  Just look to see    */
  53. /* what your colors are where and things should be pretty easy to         */
  54. /* understand.  Then again, they may not.                                 */
  55. /**************************************************************************/
  56.  
  57.      If the sizes of the font you've selected are printed in WHITE, the
  58. font is non-proportional (TOPAZ).  If they are printed in ORANGE, they are
  59. proportional (most everything else).  I added this so you can easily see
  60. what fonts you may have are non-proportional, since they are real nice when
  61. trying to make tables and stuff that needs to be columnarly [sic?]
  62. organized.  If you don't understand what I'm talking about, non-proportional
  63. fonts take up the same number of pixels per character, i.e., an 'i' takes
  64. as much space as an 'm'.  Proportional fonts space the characters according
  65. to how wide they are, i.e., an 'i' would definitely take less space to
  66. write than an 'm'.  Don't know what a pixel is?  Pixels are the small dots
  67. that can be seen if you press your face to your terminal screen.  What's
  68. a terminal screen?  Well, etc., etc.
  69.  
  70. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  71. The above explanation is a perfectly good RECURSIVE DEFINITION example.
  72. But anyway, back to the documentation.
  73. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  74.  
  75.      Clicking CANCEL when you've just booted the program without any default
  76. font will cause the program to display TOPAZ 11 (if it exists).  I don't know
  77. why it doesn't use TOPAZ 8.  I've tried to tell it to many times and in many
  78. ways, but it ignores me.  C'est la vie.  But you would never do that anyway,
  79. would you?  Someday, I'll try to track down and eliminate this one-time
  80. fault.  Version 3.2 note: the problem still eludes me.
  81.  
  82.      * NOTE * ShowFont looks in the FONTS: directory for all its fonts.
  83.      If you wish to look in another fonts directory (because you split up
  84.      your fonts into separate directories to please programs like DPaint),
  85.      exit ShowFont, re-ASSIGN FONTS: to whatever directory you like, and
  86.      then re-run ShowFont.
  87.  
  88.      For a change, I think I will try to organize this documentation a bit
  89. by listing all the menus and what each selection does.  If this is too
  90. orderly for you, please call and tell me and I'll try to make it more
  91. confusing next time.
  92.  
  93. Menu    - Option           What is it?
  94. --------------------       -----------
  95. Project - About            Gives some useless information about the program.
  96. Project - Quit             Exits the program.
  97.  
  98. Fonts   - Font Selection   Brings up the font selecting requester.
  99.  
  100. Screen  - 320 x 200        Changes the screen size to 320 x 200.
  101. Screen  - 320 x 400        Uhm...
  102. Screen  - 640 x 200        Duh...
  103. Screen  - 640 x 400        ???...
  104.  
  105.      Notice that all the menu options except the 'Screen' menu stuff have
  106. short key-equivalents, i.e., you can press Right Amiga-? to select that
  107. menu selection, where ? is whatever letter is displayed after the neat
  108. Amiga symbol in the menu.
  109.  
  110.      If the font is found, ShowFont will display "font_name-font_size" in
  111. the upper left-hand corner of the screen next to the CLOSE gadget.  To see
  112. the rest of the font (if all 256 characters cannot fit on the screen at
  113. once), use the three gadgets on the right-hand side of the screen.  Again,
  114. their function closely resembles their appearance.  Fiddle around for about
  115. three seconds and you will be quite familiar and comfortable with scrolling
  116. around a font.  Again, you can just hold down the button and scroll happily
  117. in whatever direction you like.
  118.  
  119.      Note that actually all 256 characters will not be displayed if there
  120. are blank (empty) characters.  The program will skip them, since they are
  121. rather uninteresting, being blank.  The program will display that segment
  122. of the characters that the font says should be displayed.  Two-to-one
  123. someone has some neat secret graphics just outside the official display
  124. range, but we'll never know.
  125.  
  126.      To exit the program, click on the CLOSE gadget or select the menu
  127. "Quit" option or press Right-Amiga-Q.  I like three ways to end a program!
  128. Actually, you can also end the program by:
  129.      1) Control Amiga-Amiga
  130.      2) Turning off your computer's power
  131.      3) Striking the system with great force with a large, blunt object
  132. That now makes a total of six ways to terminate the program.  I'm sure
  133. clever people will find even more imaginative and useful ways to end the
  134. font session.
  135.  
  136.      I guess the best advice I can give you for using and understanding this
  137. program is to type 'showfont' from CLI and fiddle around for a while until
  138. you either comprehend all the features or delete the program in a fit o'
  139. passion.  In fact, most bugs are detected this way through random menu and
  140. gadget selecting.
  141.  
  142.      I'll apologize now for this rather random and odd documentation file,
  143. but I'm usually dazed and confused after my program successfully runs
  144. without any apparent bugs.  On a technical note, the Lattice 5.0 C "big"
  145. compiler and global optimizer compiled this program without comment.  I like
  146. that.  I used the following to compile the program:
  147.  
  148.                  lc -g -L -M -O showfont sfstructs
  149.                  fixhunk showfont
  150.  
  151.      I would like to thank the National Type Foundry for sending me some
  152. fonts (because they are distributing my program with their product).  They do
  153. have some really nice fonts in the Roman collection.  C. Ltd. was also
  154. going to send me some information for new STYLE conventions they were
  155. petitioning Commodore for, but I never received them and lost the number and
  156. who to contact.  Maybe next time. 8-)
  157.  
  158.      That's it!  Any comments/questions/suggestions/flames/improvements/
  159. etc., can be directed to the following address:
  160.  
  161.                        *****************************
  162.                        * Arthur Johnson Jr.        *
  163.                        * 225 Montego Bay Court     *
  164.                        * Merritt Island, FL  32953 *
  165.                        *                           *
  166.                        *          - or -           *
  167.                        *                           *
  168.                        *      (407) 277-0548       *
  169.                        *****************************
  170.  
  171. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  172.      I guess I should add that this program and source are PUBLIC DOMAIN in
  173. all ways, except that if you dare to sell this program by itself for fun n'
  174. profit, you will be found and terminated.  Other than that, feel free to do
  175. whatever you like with the program, although give me some credit somewhere...
  176. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  177.  
  178.                              Revisions n' Updates
  179.                              --------------------
  180.  
  181. Version 3.2 : Eliminated slider gadgets happy post-release flickering.
  182.               Returned a satisfactory response to the system when exiting
  183.                from a RUN-ned ShowFont, exterminating that error message.
  184.               Polished the code up quite a lot for some noticeable speed
  185.                and size improvements.
  186.               Worked on the documentation some more (this will be assumed
  187.                for all future versions)
  188.               Discarded the somewhat useless and potentially dangerous
  189.                "Read FONTS:" menu option.
  190.               A few other little thingies.
  191.  
  192. Version 3.1 : Fixed a bug in the 'Read FONTS:' menu selection.
  193.               Added "double-clicking" selection method.
  194.               Cleaned up the documentation a bit.
  195.  
  196. Version 3.0 and below : These records were destroyed in the great fire,
  197.                         earthquake, plague, hurricane, tsunami, volcanic
  198.                         eruption, insect infestation, computer virus, and
  199.                         alien attack of 1988.  I apologize for any
  200.                         inconvenience this may cause.
  201.